home *** CD-ROM | disk | FTP | other *** search
/ MacHack 1998 / MacHack 1998.toast / The Hacks! / Interim Executive Decision / Outline Table Demo / About Outline Table Demo next >
Encoding:
Text File  |  1998-06-21  |  3.3 KB  |  72 lines  |  [TEXT/CWIE]
  1. ============================================
  2. Outline Table Demo
  3. John C. Daub
  4. 10 July 1997
  5. ============================================
  6.  
  7. A simple demonstration of the Outline Table classes, part of the PowerPlant
  8. "Constructor Additions".
  9.  
  10. The Outline Table classes are based upon LTableView and friends and of
  11. course follow the same basic conventions therein -- if you are not
  12. familiar with LTableView, you might want to read the PowerPlant Advanced
  13. Topics manual's chapter on Tables in PowerPlant (as well as examine
  14. the example code on tables on the CW Reference CD).
  15.  
  16. However, the outline table classes do provide for some different and
  17. interesting functionality -- there are some intracacies that just have to
  18. be watched for.
  19.  
  20. Doesn't cover every possible feature the outline table classes have nor
  21. every potential combination of table function and features, but at
  22. least covers the basics to get one started. :-)
  23.  
  24. The demo displays the contents of the #1 volume in the VCB queue in
  25. a quasi-Finder-like fashion (since that's somewhat the point behind
  26. the class, to replicate the Finder's table/list view). It will only
  27. display visible files, and will specify directories as a collapsible
  28. row (with its contents as subitems, of course) and anything not a
  29. directory is considered a file. You can even double-click on an
  30. entry and an "Open Document" AppleEvent will be sent to the Finder
  31. to open the selected item (just to be cute). :-)
  32.  
  33. The demo does not demonstrate the drag and drop capabilities that
  34. the outline classes have. Nor does it demonstrate any of the pane-hosting
  35. and in-place editing type features and functionality that the outline
  36. classes can do (this is sthe sort of thing that can be done in tables
  37. throughout Constructor, e.g. the project window, the project inspector
  38. window, etc.). Maybe I'll do this in the future, meantime you can
  39. consider it a good learning exercise :)
  40.  
  41. Two big recommendations I can give you:
  42.  
  43. 1. Ensure you understand how the PowerPlant table classes work. Go through
  44. the chapter on tables in the PowerPlant advanced topics manual, go
  45. through it's sample code, and go through the other sample table
  46. codes on the Reference CD. It's never good to build a house on sand. :)
  47.  
  48. 2. Read through ALL of the outline table classes (and their related
  49. classes) source code. There are lots of comments in the sources that
  50. explain what to do, and of course nothing is better than the source
  51. itself to explain just what something does. By reading the source code
  52. (and reading it many times if you have to until you really understand
  53. it) will greatly benefit you in the long run. Again, don't build a house
  54. on sand.
  55.  
  56. Please remember, this is a simple demonstration application. It
  57. is not a robust implementation of the table classes, it is not a robust
  58. replacement for the Finder, and might even have problems with
  59. the displaying the cutesy choice of data -- it's just not meant to
  60. be robust. If you do find bugs, please do let us know of course, but
  61. please don't expect this to do more than it's intended to do. However,
  62. if you would like to see it do more, consider it a good learning
  63. exercise for the reader. :)
  64.  
  65.  
  66. If you find any problems with this demo, have any suggestions, feedback,
  67. etc, please fill out the appropriate email report form in the Release
  68. Notes folder and send that along with your comments to support@metrowerks.com.
  69.  
  70. John C. Daub
  71. support@metrowerks.com
  72.